// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
//
// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
//
// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！

namespace Admin.NET.Application.Service.PlanViews.Dto;

/// <summary>
/// 业务月筛选器 - 统一的筛选条件模型
/// 用于替代PlanViewInput，提供更清晰的业务语义
/// </summary>
public class BusinessMonthFilter
{
    /// <summary>
    /// 业务月份，格式如 '2025-07'
    /// 注意：与前端workTime格式保持兼容
    /// </summary>
    public string WorkTime { get; set; } = string.Empty;

    /// <summary>
    /// 分类筛选
    /// 对应PlanList.ClassName字段
    /// </summary>
    public long? ClassName { get; set; }

    /// <summary>
    /// 作业区域筛选
    /// 对应PlanList.WorkAreaId字段
    /// </summary>
    public long? WorkAreaId { get; set; }

    /// <summary>
    /// 关键词搜索
    /// 用于船号、分段等文本字段的模糊搜索
    /// </summary>
    public string? Keyword { get; set; }

    /// <summary>
    /// 可选：显式起止时间（前端已计算好的业务时间范围）
    /// 优先级高于 WorkTime，当两者同时提供时，后端以该范围为准。
    /// 建议格式：本地时间，无时区，精确到毫秒。
    /// 例如：2025-07-26T00:00:00 / 2025-08-25T23:59:59.999
    /// </summary>
    public DateTime? RangeStart { get; set; }

    /// <summary>
    /// 可选：显式起止时间（前端已计算好的业务时间范围）
    /// </summary>
    public DateTime? RangeEnd { get; set; }
}
